Release 10.1A: OpenEdge Application Server:
Developing AppServer Applications

Remote persistent procedure handles

When a Progress 4GL client application executes a remote persistent procedure, two persistent procedure handles are created: one within the client application session and another separate handle within the AppServer session where the persistent procedure is created. OpenEdge internally maintains a mapping between the two handles. The handle within the client application is a proxy persistent procedure handle, and its PROXY attribute and PERSISTENT attribute are set to TRUE. The corresponding handle within the AppServer agent is a remote persistent procedure handle, and its REMOTE attribute and PERSISTENT attribute are set to TRUE.

Unlike the values of persistent procedure handles and the THIS-PROCEDURE handle that reference the same local procedure context, the proxy persistent procedure handle and the remote persistent procedure handle are truly separate handles. For example, setting the PRIVATE-DATA attribute on a remote persistent procedure handle has no effect on the PRIVATE-DATA attribute of the corresponding proxy persistent procedure handle in the client application.

For more information on the relationship between remote and proxy persistent procedure handles, see the information on procedure handles in Chapter 4, " Design and Implementation Considerations."